home *** CD-ROM | disk | FTP | other *** search
/ Aminet 49 / Aminet 49 (2002)(GTI - Schatztruhe)[!][Jun 2002].iso / Aminet / util / boot / PatchRAM.readme < prev    next >
Text File  |  2002-04-14  |  8KB  |  239 lines
  1. Short:    Patch Os 3.9 BB2 RAM-Handler to show right size
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  2.01
  5. Type:     util/boot
  6. Requires: Os 3.9 BB2, Ram-Handler 44.23
  7.  
  8. This file patches the RAM disk to show the real size occupied - its no longer
  9. 100% full. 
  10. ____________________________________________________________________________
  11.  
  12. Changes made in 2.00:
  13.  
  14. Completely new and different implementation for the Os 3.9 RAM-Handler,
  15. PatchRAM is now a permanent patch for RAM that comes in the form of a
  16. patch-file.
  17.  
  18.  
  19. Changes made in 2.00.2:
  20.  
  21. Added a new release of LoadModule.
  22.  
  23.  
  24. Changes made in 2.00.3:
  25.  
  26. Added a new release of LoadModule (again)
  27.  
  28.  
  29. Changes made in 2.01
  30.  
  31. Included a new release of LoadModule.
  32. Created a new patch for the BB2 RAM-Handler
  33. ____________________________________________________________________________
  34.  
  35.                         The THOR-Software Licence
  36.  
  37.  
  38. This License applies to the computer programs known as "PatchRAM".
  39. The "Program", below, refers to such program.
  40.  
  41.  
  42. The programs and files in this distribution are freely distributable
  43. under the restrictions stated below, but are also Copyright (c)
  44. Thomas Richter.
  45.  
  46.  
  47. Distribution of the Program by a commercial organization without written
  48. permission from the author to any third party is prohibited if any payment
  49. is made in connection with such distribution, whether directly
  50. (as in payment for a copy of the Program) or indirectly (as in payment
  51. for some service related to the Program, or payment for some product
  52. or service that includes a copy of the Program "without charge";
  53. these are only examples, and not an exhaustive enumeration of prohibited
  54. activities). However, the following methods of distribution involving
  55. payment shall not in and of themselves be a violation of this restriction:
  56.  
  57.  
  58. (i) Posting the Program on a public access information storage and
  59. retrieval service for which a fee is received for retrieving information
  60. (such as an on-line service), provided that the fee is not
  61. content-dependent (i.e., the fee would be the same for retrieving the same
  62. volume of information consisting of random data).
  63.  
  64.  
  65.  
  66. (ii) Distributing the Program on a CD-ROM, provided that the files
  67. containing the Program are reproduced entirely and verbatim on such
  68. CD-ROM, and provided further that all information on such CD-ROM be
  69. redistributable for non-commercial purposes without charge.
  70.  
  71.  
  72.  
  73. Everything in this distribution must be kept together, in original
  74. and unmodified form.
  75.  
  76.  
  77.  
  78.  
  79. Limitations.
  80.  
  81. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  82. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  83. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  84. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  85. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  86. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  87. SERVICING, REPAIR OR CORRECTION.
  88.  
  89.  
  90.  
  91. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  92. THIS ARCHIVE.
  93.  
  94. _____________________________________________________________________________
  95.  
  96.  
  97. Installation:
  98.  
  99. The installation of PatchRAM is a bit more trickier than it used to be 
  100. because it is a permanent patch and replaces the code within the RAM
  101. handler directly.
  102.  
  103. 0) Unpack the archive to wherever you want. Open a shell and change
  104. the current directory to where the archive was unpacket.
  105.  
  106. 1) Extraction of the RAM-Handler: This step requires the Os 3.9 
  107. "AmigaOs ROM Update" file and the "ExtractModule" program in this
  108. distribution. Now enter on the command line:
  109.  
  110. version "DEVS:AmigaOs ROM Update"
  111.  
  112. 2) The output of this command should be "44.57" or the patch cannot be
  113. applied.
  114.  
  115.  
  116. 3) Enter the following command on the command line:
  117.  
  118. ExtractModule from "Devs:AmigaOS ROM Update" module 17 to ram:Ram-Handler
  119.  
  120. 4) This command will place the RAM-Handler within the ROM-Updates file to
  121. RAM:Ram-Handler. Now apply the patch to this file by entering the
  122. following command:
  123.  
  124. spatch -oram:Ram-Handler.new -pRam-Handler.pch RAM:Ram-Handler
  125.  
  126. 5) This command will generate the new RAM-Handler. Copy it now to "L:" by
  127. entering the following command:
  128.  
  129. copy ram:Ram-Handler.new to L:Ram-Handler
  130.  
  131. 6) You have now two alternatives how to make use of the new Ram-Handler. As
  132. it is no longer part of the ROM-Updates file, it has to enter the system in
  133. a different way. Alternative I) is to use the "LoadModule" command, 
  134. alternative II) is to mount it manually.
  135.  
  136.  
  137. Alternative I): This will make the new RAM-Handler reset-resident in much the
  138. same way as SetPatch did.
  139.  
  140. 7) Copy the LoadModule command from this archive to C:
  141.  
  142. copy LoadModule to C:
  143.  
  144. 8) Edit the startup-sequence with an editor of your choice. In the following,
  145. let's assume the default system editor, "Ed":
  146.  
  147. Ed S:Startup-Sequence
  148.  
  149. 9) Locate the "SetPatch" command within the startup-sequence, place the
  150. cursor on the "S" of "SetPatch" and press <RETURN>. This will insert a new
  151. blank line ON TOP of SetPatch. Move the cursor upwards into this blank
  152. line and enter the following command:
  153.  
  154. LoadModule L:Ram-Handler NOREBOOT
  155.  
  156. 10) You may also load additional modules here, i.e. the Os 3.9 icon.library 
  157. or the Os 3.9 workbench.library. Just give their full paths as arguments to
  158. the LoadModule command. *NOTE THAT IT IS IMPORTANT THAT LOADMODULE IS RUN
  159. BEFORE SETPATCH*. With these modifications, the command line could look
  160. like this:
  161.  
  162. LoadModule L:Ram-Handler LIBS:icon.library LIBS:workbench.library NOREBOOT
  163.  
  164.  
  165. The advantage of "LoadModule" is that the ROM modules loaded by
  166. this command can be protected from getting overwritten by means of 
  167. the "MuProtectModules" program of the same author (not included in this archive).
  168.  
  169. 11) Locate the "SetPatch" command within the startup-sequence. Move the cursor
  170. behind "SetPatch", and add the command line option "SKIPROMMODULES ram-handler"
  171. to the command. The setpatch command line should then read approximately as
  172. follows:
  173.  
  174. SetPatch SKIPROMMODULES ram-handler >NIL:
  175.  
  176.  
  177. If you already have to skip parts of the update, as for example the scsi.device,
  178. the line should rather look like this:
  179.  
  180. SetPatch SKIPROMMODULES scsi.device,ram-handler >NIL:
  181.  
  182. 12) Save the changes of the startup-sequence back. For "Ed", press first <ESC>,
  183. then <X>, then <RETURN>.
  184.  
  185. 13) To make the changes active, a reboot is *NOT* enough. You should turn
  186. off the machine, wait for half a minute, and reboot. This will flush the
  187. RAM resident parts of the ROM-Updates mechanism.
  188.  
  189.  
  190. Alternative II): Mounting the RAM-Handler by hand in a non-reset-resident
  191. way.
  192.  
  193. 7) Copy the the files "RAM" and "RAM.info" to DEVS:DosDrivers:
  194.  
  195. copy RAM RAM.info to DEVS:DosDrivers
  196.  
  197. 8) Edit the Startup-Sequence with an editor of your choice. For the following,
  198. let's assume you use the system editor "Ed":
  199.  
  200. ed S:Startup-Sequence
  201.  
  202. 9) Locate the "SetPatch" command within the startup-sequence. Move the cursor
  203. behind "SetPatch", and add the command line option "SKIPROMMODULES ram-handler"
  204. to the command. The setpatch command line should then read approximately as
  205. follows:
  206.  
  207. SetPatch SKIPROMMODULES ram-handler >NIL:
  208.  
  209.  
  210. If you already have to skip parts of the update, as for example the scsi.device,
  211. the line should rather look like this:
  212.  
  213. SetPatch SKIPROMMODULES scsi.device,ram-handler >NIL:
  214.  
  215.  
  216. 10) Press <RETURN> and insert the following commands *BELOW* SetPatch, one in
  217. a line; note that it is important that these commands are run *AFTER* SetPatch
  218. (different from alternative I):
  219.  
  220. Assign RAM: DisMount
  221. Assign ENV: ENVARC:
  222. Mount DEVS:DosDrivers/RAM
  223. Assign ENV: Remove
  224.  
  225. 11) To save the changes back when using "Ed", press <ESC>, then <X>, then 
  226. <RETURN>. This step depends on the editor you use, though.
  227.  
  228. _____________________________________________________________________________
  229.  
  230.  
  231. For more information concerning "LoadModule", check "LoadModule.lha" on
  232. Aminet.
  233.  
  234. _____________________________________________________________________________
  235.  
  236.  
  237. April 2002,
  238.     Thomas
  239.